home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / MIDIGRAB.DOC < prev    next >
Text File  |  1995-10-21  |  4KB  |  108 lines
  1.         ******************************
  2.             MIDIGRAB v1.0
  3.     
  4.          grab midi files from uncompressed archives
  5.         extracts midi from rmi, macintosh midi, games
  6.               by Guenter Nagler 
  7.                 1995 
  8.           (gnagler@ihm.tu-graz.ac.at)
  9.         ******************************
  10.  
  11. [1] BACKGROUND
  12. Some file formats contain standard midi. But they only can be used
  13. by certain programs that can handle the special file structure.
  14. For example RIFF midi files contain a standard midi and have a 12 byte
  15. header that is only used by Microsoft MCI player. Sometimes I get
  16. midi files from Macintosh users, where the author has forgotten to 
  17. remove the macintosh specific header. 
  18.  
  19. MIDIGRAB reads such files and extracts standard midi that are placed 
  20. uncompressed at any location inside the file.
  21.  
  22. [2] FILES DESCRIPTION
  23.  
  24. MIDIGRAB.EXE..........MSDOS executable fixes structure bugs in midifiles
  25. MIDIGRAB.DOC..........this file, showing usage of MIDIGRAB.EXE
  26. MIDIGRAB.CPP..........C/C++ source code for midigrab (DOS/UNIX)
  27. only MIDIGRAB.EXE is required to run program 
  28.  
  29. [3] COPYRIGHT
  30.  
  31. MIDIGRAB (c) 1995 was created by Guenter Nagler.
  32.  
  33. MIDIGRAB is free and may be used as you wish with this one exception:
  34.  
  35.     You may NOT charge any fee or derive any profit for distribution
  36.     of MIDIGRAB.  Thus, you may NOT sell or bundle MIDIGRAB with any 
  37.     product in a retail environment (shareware disk distribution, CD-ROM,
  38.     etc.) without permission of the author.
  39.  
  40. You may give MIDIGRAB to your friends, upload it to a BBS, or ftp it to
  41. another internet site, as long as you don't charge anything for it.
  42.  
  43. [4] DISCLAIMER
  44.  
  45. MIDIGRAB does not check the contents of a midi file.
  46. So it may extract invalid midi files.
  47. Use MIDITXT -e to check the midi file content.
  48.  
  49. Use MIDIGRAB at your own risk.  Anything you do with MIDIGRAB is your
  50. responsibility, and not the author's.  Any damage caused to any person,
  51. computer, software, hardware, company, or business by running MIDIGRAB 
  52. is your responsibility, and the author will not be liable.
  53.  
  54. If you don't understand these terms, or are not sure of something, or
  55. are afraid something bad might come of using MIDIGRAB, don't  use  it!
  56. You are here forewarned.
  57.  
  58. [5] INSTALLATION 
  59.  
  60. [MSDOS]
  61.  
  62.   Simply copy MIDIGRAB.EXE in a directory that is in your path.
  63.   When you start the program without arguments
  64.  
  65.   C:\> MIDIGRAB
  66.  
  67.   you should get the usage text (see next section)
  68.  
  69. [UNIX]
  70. compile sources with your C++ compiler (e.g. GNU Compiler g++):
  71.  
  72. g++ -o midigrab midigrab.cpp 
  73.  
  74. and run program
  75.  
  76. $ midigrab
  77.  
  78. [6] USAGE
  79.  
  80. usage: MIDIGRAB filename ...
  81.  
  82. It needs one or more filenames as argument. Under DOS system wildcards
  83. are not allowed, under UNIX the system will care for interpretation.
  84. The files are used for input only and are not changed.
  85. MIDIGRAB writes midi files to next unused filename grab1.mid, grab2.mid, etc.
  86.  
  87. [7] OUTPUT MESSAGES
  88.  
  89. When MIDIGRAB finds something that looks like a standard midi, it writes:
  90.   * midi found: writing to grab1.mid
  91.   * midi found: writing to grab2.mid
  92.  
  93. When MIDIGRAB does not find a midi, it answers
  94.   * Sorry, no standard midi found
  95.  
  96. [8] SUGGESTIONS / COMMENTS / BUG REPORTS / QUESTIONS
  97.  
  98.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  99.           contains all my dos/unix midi programs
  100.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  101.  
  102. [9] USE
  103.   extract midi from: 
  104.   * RIFF midi files (*.rmi)
  105.   * Macintosh midi files that have the 128 bytes mac header (*.mid) 
  106.   * few applications (games) that store their music as midi without 
  107.     compression.
  108.